home *** CD-ROM | disk | FTP | other *** search
/ C/C++ Users Group Library 1996 July / C-C++ Users Group Library July 1996.iso / vol_200 / 219_01 / a48.doc < prev    next >
Text File  |  1989-01-11  |  46KB  |  1,176 lines

  1. /*
  2.     HEADER:        CUG219;
  3.     TITLE:        8048 Cross-Assembler (Portable);
  4.     FILENAME:    A48.DOC;
  5.     VERSION:    0.2;
  6.     DATE:        11/09/1988;
  7.  
  8.     DESCRIPTION:    "This program lets you use your computer to assemble
  9.             code for the Intel 8048 family of microprocessors.
  10.             The program is written in portable C rather than BDS
  11.             C.  All assembler features are supported except
  12.             relocation, linkage, and macros.";
  13.  
  14.     KEYWORDS:    Software Development, Assemblers, Cross-Assemblers,
  15.             Intel, 8048;
  16.  
  17.     SYSTEM:        CP/M-80, CP/M-86, HP-UX, MSDOS, PCDOS, QNIX;
  18.     COMPILERS:    Aztec C86, Aztec CII, CI-C86, Eco-C, Eco-C88, HP-UX,
  19.             Lattice C, Microsoft C,    QNIX C;
  20.  
  21.     WARNINGS:    "This program has compiled successfully on 2 UNIX
  22.             compilers, 5 MSDOS compilers, and 2 CP/M compilers.
  23.             A port to Toolworks C is untried."
  24.  
  25.     AUTHORS:    William C. Colley III;
  26. */
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.                            8048 Cross-Assembler (Portable)
  41.  
  42.  
  43.                                      Version 0.2
  44.  
  45.  
  46.                    Copyright (c) 1985,1987 William C. Colley, III
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.                               The manual such as it is.
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.           Legal Note:    This package may be used for any commercial or 
  66.                          non-commercial purpose.  It may be copied and 
  67.                          distributed freely provided that any fee charged 
  68.                          by the distributor of the copy does not exceed the 
  69.                          sum of:  1) the cost of the media the copy is 
  70.                          written on,  2) any required costs of shipping the 
  71.                          copy, and  3) a nominal handling fee.  Any other 
  72.                          distribution requires the written permission of 
  73.                          the author.  Also, the author's copyright notices 
  74.                          shall not be removed from the program source, the 
  75.                          program object, or the program documentation.
  76.  
  77.  
  78.                                   Table of Contents
  79.  
  80.           1.0  How to Use the Cross-Assembler Package ..................  3
  81.           2.0  Format of Cross-Assembler Source Lines ..................  4
  82.                2.1  Labels .............................................  5
  83.                2.2  Numeric Constants ..................................  5
  84.                2.3  String Constants ...................................  6
  85.                2.4  Expressions ........................................  6
  86.           3.0  Machine Opcodes .........................................  7
  87.                3.1  Opcodes -- No Arguments ............................  7
  88.                3.2  Opcodes -- One Argument ............................  7
  89.                3.3  Opcodes -- Two Arguments in Order ..................  8
  90.                3.4  Opcodes -- Two Arguments in Either Order ...........  8
  91.                3.5  Opcodes -- Logical Opcodes .........................  8
  92.                3.6  Opcodes -- Page Branches ...........................  8
  93.                3.7  Opcodes -- Register Page Branches ..................  9
  94.                3.8  Opcodes -- Long Branches ...........................  9
  95.                3.9  Opcodes -- MOV .....................................  9
  96.           4.0  Pseudo Opcodes ..........................................  9
  97.                4.1  Pseudo-ops -- DB ...................................  9
  98.                4.2  Pseudo-ops -- DS ................................... 10
  99.                4.3  Pseudo-ops -- DW ................................... 10
  100.                4.4  Pseudo-ops -- END .................................. 10
  101.                4.5  Pseudo-ops -- EQU .................................. 10
  102.                4.6  Pseudo-ops -- IF, ELSE, ENDIF ...................... 11
  103.                4.7  Pseudo-ops -- INCL ................................. 12
  104.                4.8  Pseudo-ops -- ORG .................................. 12
  105.                4.9  Pseudo-ops -- PAGE ................................. 12
  106.                4.10 Pseudo-ops -- REG .................................. 12
  107.                4.11 Pseudo-ops -- SET .................................. 13
  108.                4.12 Pseudo-ops -- TITL ................................. 13
  109.           5.0  Assembly Errors ......................................... 13
  110.                5.1  Error * -- Missing Statement ....................... 14
  111.                5.2  Error ( -- Parenthesis Imbalance ................... 14
  112.                5.3  Error " -- Missing Quotation Mark .................. 14
  113.                5.4  Error B -- Branch Target Not on Same Page .......... 14
  114.                5.5  Error D -- Illegal Digit ........................... 14
  115.                5.6  Error E -- Illegal Expression ...................... 14
  116.                5.7  Error I -- IF-ENDIF Imbalance ...................... 15
  117.                5.8  Error L -- Illegal Label ........................... 15
  118.                5.9  Error M -- Multiply Defined Label .................. 15
  119.                5.10 Error O -- Illegal Opcode .......................... 15
  120.                5.11 Error P -- Phasing Error ........................... 15
  121.                5.12 Error S -- Illegal Syntax .......................... 16
  122.                5.13 Error T -- Too Many Arguments ...................... 16
  123.                5.14 Error U -- Undefined Label ......................... 16
  124.                5.15 Error V -- Illegal Value ........................... 16
  125.           6.0  Warning Messages ........................................ 16
  126.                6.1  Warning -- Illegal Option Ignored .................. 16
  127.                6.2  Warning -- -l Option Ignored -- No File Name ....... 17
  128.                6.3  Warning -- -o Option Ignored -- No File Name ....... 17
  129.                6.4  Warning -- Extra Source File Ignored ............... 17
  130.                6.5  Warning -- Extra Listing File Ignored .............. 17
  131.                6.6  Warning -- Extra Object File Ignored ............... 17
  132.  
  133.  
  134.  
  135.  
  136.                                            1
  137.  
  138.  
  139.           7.0  Fatal Error Messages .................................... 17
  140.                7.1  Fatal Error -- No Source File Specified ............ 17
  141.                7.2  Fatal Error -- Source File Did Not Open ............ 17
  142.                7.3  Fatal Error -- Listing File Did Not Open ........... 17
  143.                7.4  Fatal Error -- Object File Did Not Open ............ 17
  144.                7.5  Fatal Error -- Error Reading Source File ........... 18
  145.                7.6  Fatal Error -- Disk or Directory Full .............. 18
  146.                7.7  Fatal Error -- File Stack Overflow ................. 18
  147.                7.8  Fatal Error -- If Stack Overflow ................... 18
  148.                7.9  Fatal Error -- Too Many Symbols .................... 18
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.                                            2
  198.  
  199.  
  200.           1.0  How to Use the Cross-Assembler Package
  201.  
  202.                First, the question, "What does a cross-assembler do?" needs 
  203.           to be addressed as there is considerable confusion on this point.  
  204.           A cross-assembler is just like any other assembler except that it 
  205.           runs on some CPU other than the one for which it assembles code.  
  206.           For example, this package assembles 8048 source code into 8048
  207.           object code, but it runs on an 8080, a Z-80, an 8088, or whatever 
  208.           other CPU you happen to have a C compiler for.  The reason that 
  209.           cross-assemblers are useful is that you probably already have a 
  210.           CPU with memory, disk drives, a text editor, an operating system, 
  211.           and all sorts of hard-to-build or expensive facilities on hand.  
  212.           A cross-assembler allows you to use these facilites to develop 
  213.           code for an 8048.
  214.  
  215.           This program requires one input file (your 8048 source code) and 
  216.           zero to two output files (the listing and the object).  The input 
  217.           file MUST be specified, or the assembler will bomb on a fatal 
  218.           error.